edocs Home > BEA AquaLogic Data Services Platform 3.0/3.2/3.01 Documentation

Getting Started with Advanced API Samples

Prefer all related topics on a single page? Click here.

This advanced topic supplements existing documentation that describes the invocation of ALDSP operations from Mediator API, web service, and DSP Control clients.

Specifically this topic introduces the sample and provides links to the instructions necessary to download, build, and test the samples.

Topic Map

Requirements 

Download the Sample 

You can install and work with the advanced API samples on any system with ALDSP 3.2 (server 10.1) or ALDSP 3.01 (server 9.2) installed, including the Sample Retail Application provided with ALDSP.

The advanced API samples are available as a ZIP file from:

It is recommended that the ZIP file be extracted into an ALDSP directory such as:

Install Workshop 10.2

In order to run the ALDSP Control samples you need to install Workshop 10.2 into the BEA_HOME where your ALDSP server resides.  

You can download WebLogic Workshop 10.2 from:

http://commerce.bea.com/showproduct.jsp?family=WLW&major=10.2&minor=0

Useful References

• Introducing Data Services for Client Applications
• Create Your First Data Services
• Configure the Retail Dataspace Sample Application for ALDSP 3.2
• Configure the Retail Dataspace Sample Application for ALDSP 3.01
• Data Programming Model and Update Framework
• Invoking Data Services from Java Clients

Introduction

ALDSP enables you to create client projects that invoke data service operations. These client projects can include the following, among others:

• Java projects that invoke data service functions and procedures using the Data Services Mediator API (also known as the Mediator API)
• Java-based web service applications using the Mediator API
• WebLogic Workshop projects (such as portals, business processes, and Web applications) using ALDSP Controls

  See Choosing a Client Programming Model for more information about deciding how to choose a specific client model for accessing ALDSP.

Exploring the Sample Projects

ALDSP includes a set of four sample dataspace projects, based on the Retail Dataspace example provided with ALDSP, that shows how to call ALDSP from client applications using the following:

• The static and dynamic Java Mediator APIs
• The static and dynamic Web Service Mediator API
• A DSP Control using the static and dynamic Mediator APIs

The sample dataspace projects highlight several aspects of the client development process including calling data service operations with different types of arguments and returning different return types.

The sample dataspace projects also demonstrate how to use out-of-band settings (RequestConfig), and show how to perform create, read, update, and delete operations on the data returned.

You can run the Java and Web Service Mediator samples either as standalone applications, or inside web applications. The DSP Control examples, however, must be run inside a container (WebLogic).

Related Topics

Concepts

•   Understanding the Advanced Static Mediator API Sample

How Tos

•   Setting Up the Advanced API Sample Projects
•   Running the Mediator API Sample Projects

Reference

•   Static Mediator API Code Reference
•   Dynamic Mediator API Code Reference
•   ALDSP Control Static Mediator API Code Reference
•   ALDSP Control Dynamic Mediator API Code Reference